Xbasic

FILE.STREAM_FROM_BLOB Function

Syntax

V FILE.Stream_From_Blob(P stream_to, C string, P control [,N chunksize [,N max_length]])

Arguments

stream_toPointer

A file pointer or socket pointer.

stringCharacter

A file pointer or socket pointer.

controlPointer

A pointer with two elements:

bytesNumeric

A running count of how many bytes have been streamed so far. It does not matter what you set this to, it gets reset to 0 at the beginning of the stream operation and it automatically updated as the stream progresses. This can be used to implement a progress bar.

exitLogical

A logical flag. If it is set to .t., the stream operation will abort. This can be used to implement a cancel button

chunksizeNumeric

Indicates the size of the chunks in which the stream is transferred.

max_lengthNumeric

Indicates the maximum bytes that should be streamed. The operation will stop if it reaches this size, even if there is more data available.

Description

Perform a streamed copy from a blob- control variables include .exit and .bytes .

Discussion

Streaming is a faster, optimized way of copying. The FILE.STREAM_FROM_BLOB() method copies data from a blob variable to a file or socket.

See Also